-
-
Notifications
You must be signed in to change notification settings - Fork 18.4k
DOC: Fixed PR08 and PR09 docstring errors in pandas.Series #28845
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
DOC: Fixed PR08 and PR09 docstring errors in pandas.Series #28845
Conversation
@@ -2276,31 +2276,30 @@ def to_json( | |||
orient : str | |||
Indication of expected JSON string format. | |||
|
|||
* Series | |||
* Series: | |||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@datapythonista do we want the blank lines on 2280, 2283, 2285, ...?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not sure if we have a convention for that, but I don't think so. I think it'll be more readable without them, and markdown requires them for some implementations, but I don't think rst does.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Great job, added few comments.
Note that the first line of Returns
is the type (they look like description, but they shouldn't be). So, no period at the end should be added. See: https://dev.pandas.io/docs/development/contributing_docstring.html#section-4-returns-or-yields
@@ -2276,31 +2276,30 @@ def to_json( | |||
orient : str | |||
Indication of expected JSON string format. | |||
|
|||
* Series | |||
* Series: | |||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not sure if we have a convention for that, but I don't think so. I think it'll be more readable without them, and markdown requires them for some implementations, but I don't think rst does.
how : {'start', 'end'}, default end | ||
For PeriodIndex only, see PeriodIndex.asfreq | ||
For PeriodIndex only (see PeriodIndex.asfreq). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Using next should make it a link I think:
:meth:`PeriodIndex.asfreq`
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
Co-Authored-By: Marc Garcia <[email protected]>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Lgtm, thanks for all these fixes @jackbicknell14
Thanks a lot for the fixes @jackbicknell14 |
Fixed all PR08 and PR09 issues in pandas.Series.
black pandas